/**
 * This file is part of 1genia trampoline
 * Copyright (C) 2007 1genia (contact@1genia.com)
 *
 * This library is free software; you can redistribute it and/or modify
 * it under the terms of the GNU Lesser General Public License as
 * published by the Free Software Foundation; version 3 of the License. 
 *
 * This library is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Library General Public License for more details. 
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; see the file COPYING.TXT.  If not,
 * write to the Free Software Foundation, Inc., 51 Franklin Street,
 * Fifth Floor, Boston, MA 02110-1301, USA. 
 **/
package com.genia.toolbox.web.gwt.form.client.widget.item.impl;

import java.util.ArrayList;
import java.util.List;

import com.genia.toolbox.web.gwt.form.client.form.SimpleItem;

/**
 * a base implementation of
 * {@link com.genia.toolbox.web.gwt.form.client.widget.item.SimpleItemWidget}
 * for element that have only a single value.
 * 
 * @param <ITEM>
 *          the type of item handled by this widget.
 */
public abstract class AbstractSimpleValuedItemWidget<ITEM extends SimpleItem>
    extends AbstractSimpleItemWidget<ITEM>
{

  /**
   * returns the current value of this item.
   * 
   * @return a <code>String</code> representing the current value of this item
   */
  public abstract String getValue();



  /**
   * set the current value of this item.
   * 
   * @param value
   *          a <code>String</code> representing the new value of this item
   */
  public abstract void setValue(String value);



  /**
   * returns the current values of this item.
   * 
   * @return a <code>List</code> of <code>String</code> representing the current
   *         values of this item
   */
  public List<String> getValues()
  {
    final String value = getValue();
    if (value == null) {
      return null;
    }
    final List<String> res = new ArrayList<String>();
    res.add(value);
    return res;
  }



  /**
   * set the current values of this item.
   * 
   * @param values
   *          a <code>List</code> of <code>String</code> representing the new
   *          values of this item
   */
  public void setValues(final List<String> values)
  {
    if (values == null || values.isEmpty()) {
      setValue(null);
    }
    else {
      setValue(values.get(0));
    }

  }



  /**
   * constructor.
   * 
   * @param simpleItem
   *          the item this object represents
   */
  protected AbstractSimpleValuedItemWidget(final ITEM simpleItem)
  {
    super(simpleItem);
  }
}
